OpenClaw 全平台全面板部署终极指南（2026 修正版）
⚠️ 重要声明：OpenClaw（前身为 Clawdbot/Moltbot）是独立的 AI Agent 项目，与 Anthropic 的 Claude Code 无关。本文所有信息已核对官方文档 [^0^]。
一、项目简介
OpenClaw 是由 Peter Steinberger 开发的开源 AI 个人助手（MIT 协议），特点：

本地运行：数据保留在自己的机器上

多平台交互：支持 Slack、Telegram、WhatsApp、Discord、微信等

Web 控制面板：内置可视化界面（端口 18789）

技能扩展：通过 Skills 插件系统无限扩展功能 [^3^]
GitHub： github.com/openclaw/openclaw
官网： https://openclaw.ai
文档： https://docs.openclaw.ai [^5^]
二、系统要求核对 ✅
项目 要求
Node.js ≥ 22.x（必须）
内存 ≥ 8GB（本地模型需 16GB）
存储 ≥ 20GB
操作系统 macOS / Linux / Windows WSL2
3.1 Linux（Ub# 安装依赖
sudo apt update && sudo apt install -y curl wget build-essential make g++ cmake python3

一键安装脚本

安装依赖

sudo apt update && sudo apt install -y curl wget build-essential make g++ cmake python3

一键安装脚本

curl -fsSL https://openclaw.ai/install.sh | bash
手动 npm 安装

安装 Node.js 22+

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash –
sudo apt install -y nodejs

验证版本

node -v # 需显示 v22.x.x
npm -v

安装 OpenClaw

npm install -g openclaw@latest

验证安装

openclaw –version
初始化配置

运行配置向导（配置 AI 模型 + 聊天渠道 + 技能 + Gateway）

openclaw onboard –install-daemon

或选择 QuickStart 模式自动配置

openclaw onboard –quickstart

Rocky Linux 8/9 使用 dnf

sudo dnf install -y curl wget make gcc-c++ cmake python3

后续步骤与 Ubuntu 相同

curl -fsSL https://openclaw.ai/install.sh | bash
3.2 macOS

一键安装

curl -fsSL https://openclaw.ai/install.sh | bash

或手动安装

npm install -g openclaw@latest
openclaw onboard –install-daemon
3.3 Windows（必须使用 WSL2）[^10^]
注意：OpenClaw 官方强烈推荐 WSL2，原生 Windows 支持较差

1. 管理员权限打开 PowerShell，安装 WSL2

wsl –install -d Ubuntu

重启电脑

2. 在 WSL2 Ubuntu 内执行 Linux 安装步骤

curl -fsSL https://openclaw.ai/install.sh | bash
WSL2 网络配置（如需外部访问）：# 在 WSL2 中查看 IP
ip addr show eth0 | grep ‘inet ‘

Windows 访问时使用 WSL2 的 IP:18789

四、面板类部署
4.1 1Panel（官方支持）[^11^]
确认：1Panel 应用商店确实有 OpenClaw 应用
图形化安装步骤

名称：openclaw（默认）

WebUI 端口： 18789

Bridge 端口： 18790

模型提供商：DeepSeek / Qwen / Moonshot / ZAI 等

API Key：从模型厂商获取

数据持久化：✅ 必须勾选

获取 Token 并访问 [^14^]

安装完成后，在 1Panel 终端执行

cat /opt/1panel/apps/openclaw/openclaw/data/conf/openclaw.json | grep token
访问地址
http://服务器IP:18789?token=查询到的Token值
对接 QQ 机器人（1Panel 专用）[^15^]

进入应用目录终端

docker-compose -f docker-compose-cli.yml run –rm openclaw-cli plugins install https://github.com/sliverp/qqbot.git

添加 QQ 频道

docker-compose -f docker-compose-cli.yml run –rm openclaw-cli channels add –channel qqbot –token “AppID:AppSecret”
4.2 宝塔面板（手动 Docker 部署）
注意：宝塔无官方一键应用，需手动 Docker 部署
步骤

services:
openclaw:
image: openclaw/openclaw:latest
container_name: openclaw
ports:
– “18789:18789”
– “18790:18790”
volumes:
– ./data:/app/data
– ./config:/app/config
environment:
– NODE_ENV=production
– TZ=Asia/Shanghai
restart: unless-stopped

反向代理配置（可选）
宝塔 → 网站 → 添加站点 → 反向代理：

目标 URL: http://127.0.0.1:18789
然后开启证书即可
Docker 部署详解
标准 Docker 部署

1. 克隆仓库（国内用 Gitee 镜像）

git clone https://github.com/openclaw/openclaw.git

或 git clone https://gitee.com/zhanghui_china/openclaw

cd openclaw

2. 构建镜像

docker build -t openclaw:local -f Dockerfile .

3. 运行容器

docker run -d \
–name openclaw \
-p 18789:18789 \
-p 18790:18790 \
-v $(pwd)/data:/app/data \
-e NODE_ENV=production \
openclaw:local
Docker Compose 生产配置
version: ‘3.8’
services:
openclaw:
image: openclaw/openclaw:latest
container_name: openclaw
ports:
– “18789:18789” # Web UI
– “18790:18790” # Bridge/WebSocket
volumes:
– ./data:/app/data
– ./config:/app/config
– /var/run/docker.sock:/var/run/docker.sock # 允许容器调用 Docker
environment:
– NODE_ENV=production
– TZ=Asia/Shanghai
– OPENCLAW_PORT=18789
– OPENCLAW_HOST=0.0.0.0
restart: unless-stopped
networks:
– openclaw-net

networks:
openclaw-net:
driver: bridge
网站控制面板使用

安装完成后，打开浏览器访问

http://服务器IP:18789?token=你的Token

或使用命令自动打开

openclaw dashboard
模块 功能
Chat 与 AI 对话，执行任务
Skills 安装/管理技能插件
Channels 配置 IM 对接（Slack/Telegram/微信等）
Models 切换 AI 模型和 API Key
Settings 系统配置和日志查看技能（Skills）安装 [^24^]

查看可安装技能

openclaw skills list

安装特定技能

openclaw skills install summarize
openclaw skills install browser
openclaw skills install telegram
这是通过cil安装的方式
通过 Web 面板安装

⚠️ 安全警告：安装前务必阅读 skill.md 文件，检查文件系统权限和外部 API 调用 [^25^]
Slack 配置

你的环境 推荐方案 难度 耗时 备注
Linux 服务器 一键脚本 ⭐ 5分钟 curl -fsSL https://openclaw.ai/install.sh \| bash
1Panel 面板 应用商店 ⭐ 3分钟 官方支持
宝塔面板 Docker Compose ⭐⭐ 15分钟 无官方应用，需手动 标准 Docker 推荐
Windows WSL2 + Linux 脚本 ⭐⭐⭐ 30分钟 不推荐原生 Windows
macOS 一键脚本 ⭐ 5分钟 最简单
云服务器 Docker Compose ⭐⭐ 10分钟 跨平台通用
问题 解决方案
node -v 显示版本过低 必须升级 Node.js 到 22.x
sharp 安装错误 SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
Web UI 打不开 检查防火墙/安全组是否放行 18789
容器启动失败 查看日志 docker logs openclaw
Slack 无响应 检查 Token 和权限配置，确认 Socket Mode 开启
国内网络问题 使用 Gitee 镜像或配置 npm 淘宝源
错误内容（旧版） 修正内容（新版）
❌ 项目名 Claude Code ✅ 项目名 OpenClaw
❌ 包名 clawdbot ✅ 包名 openclaw
❌ 端口 3000 ✅ 端口 18789（Web UI）、18790（Bridge）
❌ 无 Web 面板 ✅ 有 Web 控制面板 openclaw dashboard
❌ 命令 clawdbot daemon ✅ 命令 openclaw onboard --install-daemon
❌ 宝塔官方支持 ✅ 宝塔需手动 Docker
❌ 原生 Windows 支持 ✅ 必须使用 WSL2